home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / comm / news / amitin119a.lha / tin.man < prev    next >
Text File  |  1993-04-06  |  66KB  |  1,915 lines
  1.  
  2.  
  3.  
  4. TIN(1)                           LOCAL                            TIN(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      tin, rtin, cdtin, tind - A threaded Netnews reader
  10.  
  11. SYNOPSIS
  12.      tin/rtin/cdtin/tind [ options ] [ newsgroups ]
  13.  
  14. DESCRIPTION
  15.      Tin is a full-screen easy to use threaded Netnews reader. It
  16.      can  read  news  locally  (i.e. /usr/spool/news) or remotely
  17.      (rtin or tin -r option) via a NNTP (Network  News  Transport
  18.      Protocol)  server.   Cdtin  can  read  news locally and news
  19.      archived on  CD-ROM.  The  manipulation  of  MH  style  mail
  20.      folders is also supported.
  21.  
  22.      Tin has five separate levels of operation:  Group  selection
  23.      level,  Spooldir  selection level, Group level, Thread level
  24.      and Article level.  Use the 'h' (help)  command  to  view  a
  25.      list of the commands available at a particular level.
  26.  
  27.      On startup tin will show a list of the newsgroups  found  in
  28.      $HOME/.newsrc.  An  arrow '->' or highlighted bar will point
  29.      to the first  newsgroup.  Move  to  a  group  by  using  the
  30.      terminal  arrow  keys  (terminal  dependent) or 'j' and 'k'.
  31.      Use PgUp/PgDn (terminal dependent) or Ctrl-U and  Ctrl-D  to
  32.      page up/down.  Enter a newsgroup by pressing RETURN.
  33.  
  34.      The TAB key advances  to  the  next  newsgroup  with  unread
  35.      articles and enters it.
  36.  
  37. OPTIONS
  38.      -c          create/update index files  for  every  group  in
  39.                  $HOME/.newsrc or file specified by -f option and
  40.                  mark all articles as read.
  41.  
  42.      -f file     use  the  specified  file   of   subscribed   to
  43.                  newsgroups in place of $HOME/.newsrc.
  44.  
  45.      -h          help listing all command line options.
  46.  
  47.      -H          brief introduction to tin that is also shown the
  48.                  first time it is started.
  49.  
  50.      -I dir      directory in  which  to  store  newsgroup  index
  51.                  files.  Default is $HOME/.tin/.index.
  52.  
  53.      -m dir      mailbox   directory   to   use.    Default    is
  54.                  $HOME/Mail.
  55.  
  56.      -M user     mail unread articles to specified user for later
  57.                  reading.   For  more  information  read  section
  58.                  Automatic Mailing and Saving New News.
  59.  
  60.  
  61.  
  62.  
  63. April 6, 1993         Last change: Version 1.1 PL9                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TIN(1)                           LOCAL                            TIN(1)
  71.  
  72.  
  73.  
  74.      -p program  print program with options.
  75.  
  76.      -q          quick start without checking for new newsgroups.
  77.  
  78.      -P          purge group index  files  of  articles  that  no
  79.                  longer  exist.  Care  should be taken when using
  80.                  this command as it stats each and every  article
  81.                  in  each  group that is accessed. On a low speed
  82.                  connection this can have an  undisirable  effect
  83.                  and   it  also  knocks  the  hell  out  of  your
  84.                  filesystem.
  85.  
  86.      -r          read news remotely from the default NNTP  server
  87.                  specified in the environment variable NNTPSERVER
  88.                  or contained in the file /etc/nntpserver.
  89.  
  90.      -R          read  news  saved  by   -S   option   (not   yet
  91.                  implemented).
  92.  
  93.      -s dir      save  articles   to   directory.    Default   is
  94.                  $HOME/News.
  95.  
  96.      -S          save unread articles for  later  reading  by  -R
  97.                  option.    For  more  information  read  section
  98.                  Automatic Mailing and Saving New News.
  99.  
  100.      -u          create/update index files  for  every  group  in
  101.                  $HOME/.newsrc  or  file  specified by -f option.
  102.                  This option is disabled  if  tin  retreives  its
  103.                  index files via a NNTP server.
  104.  
  105.      -U          start tin in  the  background  to  update  index
  106.                  files  while  reading  news  in  the foreground.
  107.                  This option is disabled  if  tin  retreives  its
  108.                  index files via a NNTP server.
  109.  
  110.      -v          verbose mode for -c -M -S -u and -Z options.
  111.  
  112.      -w          quick mode to post an article and then exit.
  113.  
  114.      -z          only start tin if there is any new/unread  news.
  115.                  If  there  is  news  tin will position cursor at
  116.                  first group with unread news. Useful for putting
  117.                  in login file.
  118.  
  119.      -Z          check if there is any new/unread news  and  exit
  120.                  with   appropriate  status.   If  -v  option  is
  121.                  specified the number of unread articles in  each
  122.                  group  is  printed.  An exit code 0 indicates no
  123.                  news, 1  that  an  error  occurred  and  2  that
  124.                  new/unread  news  exists.   Useful  for  writing
  125.                  scripts.
  126.  
  127.  
  128.  
  129. April 6, 1993         Last change: Version 1.1 PL9                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. TIN(1)                           LOCAL                            TIN(1)
  137.  
  138.  
  139.  
  140.      Tin can also dynamically change its options by the 'M'  menu
  141.      command.  Any changes are written to $HOME/.tin/tinrc.
  142.  
  143.      The index daemon version, tind, only supports the -f, -h, -I
  144.      and -v options.
  145.  
  146. INDEX FILES
  147.      In order to keep track of threads, tin  maintains  an  index
  148.      for  each  newsgroup. There are a number of methods in which
  149.      index files can be created and updated.
  150.  
  151.      The simplest method is that each user creates/updates  there
  152.      own  index  files that are stored in $HOME/.tin/.index. This
  153.      has the advantage that any user can compile and install tin,
  154.      but  the  disadvantage  is  that  each  user  is going to be
  155.      creating duplicate files and using precious disk  space.   A
  156.      good  way  to  keep index files updated is by doing a tin -U
  157.      that will update index files in the background while you are
  158.      reading  news  in  the foreground. You can also update index
  159.      files via the system batcher cron with the -u option:
  160.           30 6 * * * /usr/local/bin/tin -u
  161.  
  162.      A slightly better method is to set tin setuid news and  have
  163.      all  index  files  created  and  updated  in  the news spool
  164.      directory  (i.e.  /usr/spool/news/.index).  This   has   the
  165.      advantage  that  there  will  only  be one copy of the index
  166.      files on each machine on your network, but the  disadvantage
  167.      is that you will have tin running setuid news.
  168.  
  169.      A better method is to install the tind index  file  updating
  170.      daemon  and  have  it  create and update index files for all
  171.      groups in your active file at regular intervals in the  news
  172.      spool  directory (i.e. /usr/spool/news/.index). This has the
  173.      advantage that there will only be  one  copy  of  the  index
  174.      files  on  each  machine on your network and tin must not be
  175.      setuid news, but the disadvantage is that you will  have  to
  176.      have  news  permissions to install tind and root permissions
  177.      to install an entry in the cron batcher system to have  tind
  178.      regularly update index files.
  179.  
  180.      The best method is to install the tind index  file  updating
  181.      daemon  on  your  NNTP  server and have it create and update
  182.      index files for all groups in your active  file  at  regular
  183.      intervals    in    the    news    spool    directory   (i.e.
  184.      /usr/spool/news/.index).  This has the advantage that  there
  185.      will  only be one copy of the index files on the NNTP server
  186.      for the whole of your network, but the disadvantage is  that
  187.      you will have to install my NNTP server patches to allow tin
  188.      to retreive index file from your NNTP  server  and  and  you
  189.      must  install  an  entry  in the cron batcher system to have
  190.      tind regularly update index files (note  that  this  is  the
  191.      method  we use on our network of 40-50 machines and have not
  192.  
  193.  
  194.  
  195. April 6, 1993         Last change: Version 1.1 PL9                     3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. TIN(1)                           LOCAL                            TIN(1)
  203.  
  204.  
  205.  
  206.      had any problems).
  207.  
  208.      Entering a group the first time tends to be slow because the
  209.      index file must be built from scratch unless the tind update
  210.      daemon is being used. To alleviate the slowness start tin to
  211.      create  all index files for the groups you subscribe to with
  212.      tin -u -v and go for a  coffee.  Subsequent  readings  of  a
  213.      group will cause incremental updating of the index file.
  214.  
  215.      If reading news remotely and locally  updating  index  files
  216.      operation  will be somewhat slower because the articles must
  217.      be retreived from the NNTP server.
  218.  
  219. NEWS ADMINISTRATION
  220.      Maintaining Netnews on large networks of machines can  be  a
  221.      pretty  time  consuming job as I discovered when I was given
  222.      the job of maintaining our news system and news users.
  223.  
  224.      Tin is a News User Agent and  so  most  of  the  users  were
  225.      always  asking  questions  or  doing  things  that  could be
  226.      frowned upon by there departments.  To releive  news  admins
  227.      (and especially me) of this features have been added to make
  228.      life easier for news adminstrators.
  229.  
  230.      When a user starts tin it is possible to inform them of  any
  231.      important  changes/information concerning the news system by
  232.      displaying a message of the day (motd) file. The  motd  file
  233.      should   be   created  in  your  news  lib  directory  (i.e.
  234.      /usr/lib/news/motd) and should have file permissions set  to
  235.      0644.  The  motd file will only be displayed if its contents
  236.      is newer than the last time the user started tin. If reading
  237.      news  via NNTP my XMOTD patch will have to have been applied
  238.      to your NNTP server.
  239.  
  240.      A user starting tin for the first time can be  automatically
  241.      subscribed   to   a  list  of  newsgroups  that  are  deemed
  242.      appropriate by the  news  administrator.  At  our  site  the
  243.      subscriptions  file has 125 groups (our active file contains
  244.      over 400 groups with many only being marginally  interesting
  245.      to  most  people).  The subscriptions file should be created
  246.      in      your      news       lib       directory       (i.e.
  247.      /usr/lib/news/subscriptions)    and    should    have   file
  248.      permissions set to 0644. If reading news via  NNTP  my  LIST
  249.      SUBSCRIPTIONS  patch  will have to have been applied to your
  250.      NNTP server.
  251.  
  252.      If my NNTP XUSER patch has been applied to your NNTP  server
  253.      you  will  be  able  to log the username and machine to your
  254.      NNTP logfile for usage statistics.
  255.  
  256. SCREEN FORMAT
  257.      Tin has five separate levels of operation:  Group  selection
  258.  
  259.  
  260.  
  261. April 6, 1993         Last change: Version 1.1 PL9                     4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. TIN(1)                           LOCAL                            TIN(1)
  269.  
  270.  
  271.  
  272.      level,  Spooldir  selection level, Group level, Thread level
  273.      and Article level.
  274.  
  275.      At the Group Selection level the title displays  the  number
  276.      of  subscribed  groups.  The newsgroups are displayed on the
  277.      left of the  screen  with  the  number  of  unread  articles
  278.      displayed on the same line in the middle of the screen.
  279.                <Selection Num> <Newsgroup> <Num of unread articles>
  280.           i.e.,
  281.                1  alt.sources            10
  282.                2  comp.sources.misc      3
  283.                3  news.software.readers  12
  284.  
  285.      At the Group level the title contains the name of the group,
  286.      the  number  of  conversation  threads  and  total number of
  287.      articles i.e., alt.sources (7 23).  If the  group  has  been
  288.      setup  not  to  thread  articles  (i.e.,  alt.sources  is in
  289.      $(HOME)/.tin/unthread) the title will be alt.sources (U 23).
  290.      There are two possible display formats as shown below:
  291.                <Selection Num> <Unread> <Responses> <Subject> <Author>
  292.           i.e.,
  293.                1   +   3   Bnews sources?      iain@anl433.uucp
  294.                2       1   This question has   ether@net
  295.           or
  296.                <Selection Num> <Unread> <Responses> <Subject (longer)>
  297.           i.e.,
  298.                1   +   3   Bnews sources?
  299.                2       1   This question has a longer subject line
  300.  
  301.      At the Article level  the  page  header  has  the  following
  302.      format:
  303.                <Date posted> <Newsgroup>    <Thread 1 of n>
  304.                <Article Num> <Subject>      <Num of responses in thread>
  305.                <Author>                     <Organization>
  306.  
  307.                <Article body>
  308.           i.e.,
  309.                24 Jul 15:20:03 GMT   alt.sources      Thread 1 of 2
  310.                Article 452           Bnews sources?   3 responses
  311.                iain@anl433.uucp                       Organization name
  312.  
  313.                <Article boby>
  314.  
  315. COMMON MOVING KEYS
  316.      This table shows the common keys/commands for moving at  all
  317.      five levels within tin.
  318.                                      ansi/at386/vt100  Other Terminals
  319.           Beginning of list/article  Home              1 (^R or g at article level)
  320.           End of list/article        End               $ (also G at article level)
  321.           Page Up                    PgUp              ^U or ^B or b
  322.           Page Down                  PgDn              ^D or ^F or <SPACE>
  323.           Line Up                    Up arrow          k (not at article level)
  324.  
  325.  
  326.  
  327. April 6, 1993         Last change: Version 1.1 PL9                     5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. TIN(1)                           LOCAL                            TIN(1)
  335.  
  336.  
  337.  
  338.           Line Down                  Down arrow        j (not at article level)
  339.  
  340. COMMON EDITING COMMANDS
  341.      An emacs style editing package allows the  easy  editing  of
  342.      input  strings.   An  history  list allows the easy reuse of
  343.      previously entered  strings.   The  following  commands  are
  344.      available when editing a string:
  345.  
  346.      ^A,^E     move to beginning or end of line, respectively.
  347.  
  348.      ^F,^B     nondestructive move forward or back one  location,
  349.                respectively.
  350.  
  351.      ^D        delete the character currently under  the  cursor,
  352.                or send EOF if no characters in the buffer.
  353.  
  354.      ^H,<DEL>  delete character left of the cursor.
  355.  
  356.      ^K        delete from cursor to end of line.
  357.  
  358.      ^P,^N     move   through   history,   previous   and   next,
  359.                respectively.
  360.  
  361.      ^L,^R     redraw the current line.
  362.  
  363.      <CR>      places line on history list if  nonblank,  appends
  364.                newline and returns to the caller.
  365.  
  366.      <ESC>     aborts the present editing operation.
  367.  
  368. NEWSGROUP SELECTION COMMANDS
  369.      4         Select group 4.
  370.  
  371.      ^K        Delete current group from $HOME/.newsrc file.
  372.  
  373.      ^L        Redraw page.
  374.  
  375.      ^R        Reset $HOME/.newsrc file.
  376.  
  377.      <CR>      Read current group.
  378.  
  379.      <TAB>     View next group with unread news. Will wrap around
  380.                to  the  beginning  of  the  group  selection list
  381.                looking for unread groups.
  382.  
  383.      c         Mark current group as all read  with  confirmation
  384.                and goto next group in group selection list.
  385.  
  386.      C         Mark current group  as  all  read  and  goto  next
  387.                unread group in group selection list.
  388.  
  389.      d         Toggle display to show just the groupname  or  the
  390.  
  391.  
  392.  
  393. April 6, 1993         Last change: Version 1.1 PL9                     6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. TIN(1)                           LOCAL                            TIN(1)
  401.  
  402.  
  403.  
  404.                groupname and the groups description.
  405.  
  406.      g         Choose a new group by name.  The position  of  the
  407.                group  within  the  group  list will also be asked
  408.                for.  By entering '1' the new group  will  be  the
  409.                first group in the displayed list, by entering '8'
  410.                the group will be the eighth  group  in  the  list
  411.                etc.   By  entering '$' the group will be the last
  412.                group displayed.
  413.  
  414.      h         Help screen of newsgroup selection commands.
  415.  
  416.      H         Toggle the display of help mini menu at the bottom
  417.                of the screen.
  418.  
  419.      I         Toggle inverse video.
  420.  
  421.      l         List and allow selection of  the  available  spool
  422.                directories.   This  feature  requires  a  special
  423.                library to be linked  with  tin  to  create  cdtin
  424.                which  can then read news from an active news feed
  425.                and also from multiple CD-ROMs.
  426.  
  427.      m         Move the current group within the group  selection
  428.                list.   By  entering '1' the group will become the
  429.                first displayed group in the list, by entering '8'
  430.                the eighth group in the list etc.  By entering '$'
  431.                the group will be the last group displayed.
  432.  
  433.      M         User   configurable   options   menu   (for   more
  434.                information see section Options Menu).
  435.  
  436.      q         Quit tin.
  437.  
  438.      Q         Quit tin.
  439.  
  440.      r         Toggle display of all  subscribed  to  groups  and
  441.                just  the  subscribed  to groups containing unread
  442.                articles. Command has no  effect  if  groups  were
  443.                read from the command line when tin was started.
  444.  
  445.      R         Mail a bug report or comment to the author.   This
  446.                is the best way of getting bugs fixed and features
  447.                added/changed.
  448.  
  449.      s         Subscribe to current group.
  450.  
  451.      S         Subscribe  to  groups  matching   user   specified
  452.                pattern.
  453.  
  454.      u         Unsubscribe to current group.
  455.  
  456.  
  457.  
  458.  
  459. April 6, 1993         Last change: Version 1.1 PL9                     7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. TIN(1)                           LOCAL                            TIN(1)
  467.  
  468.  
  469.  
  470.      U         Unsubscribe  to  groups  matching  user  specified
  471.                pattern.
  472.  
  473.      v         Print tin version information.
  474.  
  475.      w         Post an article to current group.
  476.  
  477.      W         List articles posted by user.   The  date  posted,
  478.                the newsgroup and the subject are listed.
  479.  
  480.      y         The first time this command is called it will yank
  481.                in  all groups from $LIBDIR/active that are not in
  482.                $HOME/.newsrc.   After  any   groups   have   been
  483.                subscribed/unsubscribed   to,   this   command  if
  484.                pressed  again  will  reread   $HOME/.newsrc   and
  485.                display only the subscribed groups.
  486.  
  487.      Y         Reread the active file to see if any new news  has
  488.                arrived since starting tin.
  489.  
  490.      z         Mark all articles in the current group as unread.
  491.  
  492.      Z         Undelete previously deleted group  by  ^K  command
  493.                from $HOME/.newsrc.
  494.  
  495.      /         Group forward search.
  496.  
  497.      ?         Group backward search.
  498.  
  499. SPOOL DIRECTORY SELECTION COMMANDS
  500.      4         Select spool directory 4.
  501.  
  502.      ^L        Redraw page.
  503.  
  504.      <CR>      Read news from selected spool directory.
  505.  
  506.      h         Help screen of spool directory selection commands.
  507.  
  508.      H         Toggle the display of help mini menu at the bottom
  509.                of the screen.
  510.  
  511.      I         Toggle inverse video.
  512.  
  513.      q         Return to previous level.
  514.  
  515.      Q         Quit tin.
  516.  
  517.      R         Mail a bug report or comment to the author.   This
  518.                is the best way of getting bugs fixed and features
  519.                added/changed.
  520.  
  521.      v         Print tin version information.
  522.  
  523.  
  524.  
  525. April 6, 1993         Last change: Version 1.1 PL9                     8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. TIN(1)                           LOCAL                            TIN(1)
  533.  
  534.  
  535.  
  536. GROUP INDEX COMMANDS
  537.      4         Select article 4.
  538.  
  539.      ^K        Kill current article (for  more  information  read
  540.                section Kill Article Menu).
  541.  
  542.      ^L        Redraw page.
  543.  
  544.      <CR>      Read current article.
  545.  
  546.      <TAB>     View next unread article or group.
  547.  
  548.      a         Author forward search.
  549.  
  550.      A         Author backward search.
  551.  
  552.      c         Mark all articles as read with confirmation.
  553.  
  554.      C         Mark all articles as read and goto next group with
  555.                unread news.
  556.  
  557.      d         Toggle display to show just  the  subject  or  the
  558.                subject and author.
  559.  
  560.      g         Choose a new group by name.
  561.  
  562.      h         Help screen of group index commands.
  563.  
  564.      H         Toggle the display of help mini menu at the bottom
  565.                of the screen.
  566.  
  567.      I         Toggle inverse video.
  568.  
  569.      K         Mark article/thread as read and  advance  to  next
  570.                unread article/thread.
  571.  
  572.      l         List the author of each response in current thread
  573.                and enter thread selection level.
  574.  
  575.      m         Mail current article  /  thread  /  auto  selected
  576.                (hot)  articles  /  articles  matching  pattern  /
  577.                tagged articles to someone.
  578.  
  579.      M         User   configurable   options   menu   (for   more
  580.                information see section Options Menu).
  581.  
  582.      n         Go to next group.
  583.  
  584.      N         Go to next unread article.
  585.  
  586.      o         Output current article / thread  /  auto  selected
  587.                (hot)  articles  /  articles  matching  pattern  /
  588.  
  589.  
  590.  
  591. April 6, 1993         Last change: Version 1.1 PL9                     9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. TIN(1)                           LOCAL                            TIN(1)
  599.  
  600.  
  601.  
  602.                tagged articles to printer.
  603.  
  604.      p         Go to previous group.
  605.  
  606.      P         Go to previous unread article.
  607.  
  608.      q         Return to previous level.
  609.  
  610.      Q         Quit tin.
  611.  
  612.      R         Mail a bug report or comment to the author.   This
  613.                is the best way of getting bugs fixed and features
  614.                added/changed.
  615.  
  616.      s         Save current article  /  thread  /  auto  selected
  617.                (hot)  articles  /  articles  matching  pattern  /
  618.                tagged articles to file /  files  /  mailbox.   To
  619.                save  to  a  mailbox  enter '=' or '=mailbox' when
  620.                asked  for  filename  to  save  to.   To  save  in
  621.                <newsgroup     name>/<filename>    format    enter
  622.                '+filename'.  Environment  variables  are  allowed
  623.                within a filename (i.e. $SOURCES/dir/filename).
  624.  
  625.      t         Tag current article / thread for mailing  ('m')  /
  626.                piping  ('|')  /  printing  ('o') / saving ('s') /
  627.                crossposting ('x').
  628.  
  629.      u         Toggle display to show all articles as  unthreaded
  630.                or threaded.
  631.  
  632.      U         Untag all articles that were tagged.
  633.  
  634.      v         Print tin version information.
  635.  
  636.      w         Post an article to current group.
  637.  
  638.      W         List articles posted by user.   The  date  posted,
  639.                the newsgroup and the subject are listed.
  640.  
  641.      x         Crosspost already posted current article /  thread
  642.                / auto selected (hot) articles / articles matching
  643.                pattern / tagged articles to another newsgroup(s).
  644.                Useful   for   reposting   from  global  to  local
  645.                newsgroups.
  646.  
  647.      X         Mark  all  unread  articles  that  have  not  been
  648.                selected  as  read, redo screen to reflect changes
  649.                and  put  index  at  the  first  thread  to  begin
  650.                reading.  Pressing  'X'  again will toggle back to
  651.                the  way  it  was  before.  See  '~'  command  for
  652.                clearing the toggle effect.
  653.  
  654.  
  655.  
  656.  
  657. April 6, 1993         Last change: Version 1.1 PL9                    10
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. TIN(1)                           LOCAL                            TIN(1)
  665.  
  666.  
  667.  
  668.      z         Mark current article as unread.
  669.  
  670.      Z         Mark current thread as unread.
  671.  
  672.      /         Search forward for specified subject.
  673.  
  674.      ?         Search backward for specified subject.
  675.  
  676.      -         Show last message.
  677.  
  678.      |         Pipe current article  /  thread  /  auto  selected
  679.                (hot)  articles  /  articles  matching  pattern  /
  680.                tagged articles into command.
  681.  
  682.      *         Select current thread for later processing.
  683.  
  684.      Toggle selection of current thread. If at least one unread art,
  685.                but  not  all  unread arts, in thread is selected,
  686.                then all unread arts become selected.
  687.  
  688.      @         Reverse all selections on all articles.
  689.  
  690.      ~         Undo all selections on all articles. It clears the
  691.                toggle  effect  of  'X'  command. Thus after first
  692.                doing  a  'X',  one  can  then  do  '~'  to  reset
  693.                articles.  Thus,  one can iteratively whittle down
  694.                uninteresting threads.
  695.  
  696.      +         Perform auto-selection on current group.
  697.  
  698.      ;         For each thread in current group, if it  at  least
  699.                one unread art is selected, all unread arts become
  700.                selected. This is  useful  for  auto-selection  on
  701.                author where reader wants to see entire thread.
  702.  
  703.      =         Prompts for a pattern with which to match on.  All
  704.                threads  whose  subjects match the pattern will be
  705.                selected.  A  pattern  of  "*"  will   match   all
  706.                subjects.   Entering  just  <CR>  will  cause  the
  707.                previous pattern to be used.
  708.  
  709. THREAD LISTING COMMANDS
  710.      4         Select article 4 within thread.
  711.  
  712.      ^L        Redraw page.
  713.  
  714.      <CR>      Read current article within thread.
  715.  
  716.      <TAB>     View next unread article within thread.
  717.  
  718.      c         Mark thread as read after confirmation and  return
  719.                to previous level.
  720.  
  721.  
  722.  
  723. April 6, 1993         Last change: Version 1.1 PL9                    11
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. TIN(1)                           LOCAL                            TIN(1)
  731.  
  732.  
  733.  
  734.      d         Toggle display to show just  the  subject  or  the
  735.                subject and author.
  736.  
  737.      h         Help screen of thread listing commands.
  738.  
  739.      H         Toggle the display of help mini menu at the bottom
  740.                of the screen.
  741.  
  742.      I         Toggle inverse video.
  743.  
  744.      K         Mark thread as read and return to previous level.
  745.  
  746.      q         Return to previous level.
  747.  
  748.      Q         Quit tin.
  749.  
  750.      r         Toggle display to show all articles or only unread
  751.                articles.
  752.  
  753.      R         Mail a bug report or comment to the author.   This
  754.                is the best way of getting bugs fixed and features
  755.                added/changed.
  756.  
  757.      t         Tag current article for  mailing  ('m')  /  piping
  758.                ('|')   /   printing   ('o')   /  saving  ('s')  /
  759.                crossposting ('x').
  760.  
  761.      T         Return to group index level.
  762.  
  763.      v         Print tin version information.
  764.  
  765.      z         Mark current article in thread as unread.
  766.  
  767.      Z         Mark all articles in thread as unread.
  768.  
  769. ARTICLE VIEWER COMMANDS
  770.      0         Read the base article in this thread.
  771.  
  772.      4         Read response 4 in this thread.
  773.  
  774.      ^H        Show all of the articles mail header.
  775.  
  776.      ^K        Kill current article (for  more  information  read
  777.                section Kill Article Menu).
  778.  
  779.      ^L        Redraw page.
  780.  
  781.      <CR>      Goto next base article.
  782.  
  783.      <TAB>     Goto next unread article.
  784.  
  785.      a         Author forward search.
  786.  
  787.  
  788.  
  789. April 6, 1993         Last change: Version 1.1 PL9                    12
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. TIN(1)                           LOCAL                            TIN(1)
  797.  
  798.  
  799.  
  800.      A         Author backward search.
  801.  
  802.      c         Mark all articles as read  with  confirmation  and
  803.                return to group selection level.
  804.  
  805.      C         Mark current group  as  all  read  and  goto  next
  806.                unread group in group selection list.
  807.  
  808.      d         Toggle rot-13 decoding for this article.
  809.  
  810.      D         Delete current article.  It must have been  posted
  811.                by  the same user.  The cancel message can be seen
  812.                in the newsgroup 'control'.
  813.  
  814.      f         Post a followup to the current article with a copy
  815.                of the article included.
  816.  
  817.      F         Post a followup to the current article.
  818.  
  819.      h         Help screen of article page commands.
  820.  
  821.      H         Toggle the display of help mini menu at the bottom
  822.                of the screen.
  823.  
  824.      I         Toggle inverse video.
  825.  
  826.      k         Mark article as read and advance  to  next  unread
  827.                article.
  828.  
  829.      K         Mark thread as read and  advance  to  next  unread
  830.                thread.
  831.  
  832.      m         Mail current article  /  thread  /  auto  selected
  833.                (hot)  articles  /  articles  matching  pattern  /
  834.                tagged articles to someone.
  835.  
  836.      M         User   configurable   options   menu   (for   more
  837.                information see section Options Menu).
  838.  
  839.      n         Go to the next article.
  840.  
  841.      N         Go to the next unread article.
  842.  
  843.      o         Output current article / thread  /  auto  selected
  844.                (hot)  articles  /  articles  matching  pattern  /
  845.                tagged articles to printer.
  846.  
  847.      o         Output article/thread/tagged articles to printer.
  848.  
  849.      p         Go to the previous article.
  850.  
  851.      P         Go to the previous unread article.
  852.  
  853.  
  854.  
  855. April 6, 1993         Last change: Version 1.1 PL9                    13
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. TIN(1)                           LOCAL                            TIN(1)
  863.  
  864.  
  865.  
  866.      q         Return to previous level.
  867.  
  868.      Q         Quit tin.
  869.  
  870.      r         Reply through mail to the author  of  the  current
  871.                article with a copy of the article included.
  872.  
  873.      R         Reply through mail to the author  of  the  current
  874.                article.
  875.  
  876.      s         Save current article  /  thread  /  auto  selected
  877.                (hot)  articles  /  articles  matching  pattern  /
  878.                tagged articles to file /  files  /  mailbox.   To
  879.                save  to  a  mailbox  enter '=' or '=mailbox' when
  880.                asked  for  filename  to  save  to.   To  save  in
  881.                <newsgroup  name>/<filename>  format  enter  (i.e.
  882.                $SOURCES/dir/filename).
  883.  
  884.      t         Return to group selection level.
  885.  
  886.      T         Tag current article for  mailing  ('m')  /  piping
  887.                ('|')   /   printing   ('o')   /  saving  ('s')  /
  888.                crossposting ('x').
  889.  
  890.      v         Print tin version information.
  891.  
  892.      w         Post an article to current group.
  893.  
  894.      W         List articles posted by user.   The  date  posted,
  895.                the newsgroup and the subject are listed.
  896.  
  897.      x         Crosspost already posted current article /  thread
  898.                / auto selected (hot) articles / articles matching
  899.                pattern / tagged articles to another newsgroup(s).
  900.                Useful   for   reposting   from  global  to  local
  901.                newsgroups.
  902.  
  903.      z         Mark article as unread.
  904.  
  905.      /         Article forward search.
  906.  
  907.      ?         Article backward search
  908.  
  909.      |         Pipe current article  /  thread  /  auto  selected
  910.                (hot)  articles  /  articles  matching  pattern  /
  911.                tagged articles into command.
  912.  
  913.      <         Goto the first article in the current thread.
  914.  
  915.      >         Goto the last article in the current thread.
  916.  
  917.      *         Select current thread for later processing.
  918.  
  919.  
  920.  
  921. April 6, 1993         Last change: Version 1.1 PL9                    14
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. TIN(1)                           LOCAL                            TIN(1)
  929.  
  930.  
  931.  
  932.      Toggle selection of current article.
  933.  
  934.      @         Reverse article selections.
  935.  
  936.      ~         Undo all selections on current thread.
  937.  
  938. GLOBAL OPTIONS MENU
  939.      This menu is accessed by pressing 'M'  at  all  levels.   It
  940.      allows  the  user  to  customize  the  behaviour of tin. The
  941.      options are saved to the file $HOME/.tin/tinrc.  Use <SPACE>
  942.      to toggle the required option and <CR> to set.
  943.  
  944.      Auto save
  945.          Automatically save articles/threads by ``Archive-name:''
  946.          line  in article header and post process them if process
  947.          type is not set to None.
  948.  
  949.      Editor offset
  950.          Set ON if the editor used for  posting,  follow-ups  and
  951.          bug   reports   has   the  capability  of  starting  and
  952.          positioning the cursor at  a  specified  line  within  a
  953.          file.
  954.  
  955.      Mark saved read
  956.          Allows saved articles/threads to be automatically marked
  957.          as read.
  958.  
  959.      Confirm Command
  960.          Allows certain commands (i.e. 'c' catchup) that  require
  961.          user confirmation to be executed immediately if set OFF.
  962.  
  963.      Draw arrow
  964.          Allows groups/articles to be selected by an  arrow  '->'
  965.          if set ON or by an highlighted bar if set OFF.
  966.  
  967.      Print header
  968.          This  allows  the  complete  mail  header  or  only  the
  969.          ``Subject:''  and  ``From:''  fields  to  be output when
  970.          printing articles.
  971.  
  972.      Goto 1st unread
  973.          This allows the cursor to be placed at the first /  last
  974.          unread  article  upon  entering  a newsgroup with unread
  975.          news.
  976.  
  977.      Scroll full page
  978.          If set ON scrolling of groups/articles will  be  a  full
  979.          page at a time, otherwise half a page at a time.
  980.  
  981.      Catchup on quit
  982.          If set ON the user is asked when quitting if all  groups
  983.          read during the current session should be marked read.
  984.  
  985.  
  986.  
  987. April 6, 1993         Last change: Version 1.1 PL9                    15
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994. TIN(1)                           LOCAL                            TIN(1)
  995.  
  996.  
  997.  
  998.      Thread articles
  999.          If set ON  articles  will  be  threaded  in  all  groups
  1000.          (default),  otherwise articles will be shown unthreaded.
  1001.          Threading/unthreading is possible on a per  group  basis
  1002.          by setting the group attribute variable 'thread_arts' to
  1003.          ON/OFF in the file $HOME/.tin/attributes.
  1004.  
  1005.      Show only unread
  1006.          If set ON show only new/unread articles, otherwise  show
  1007.          all articles.
  1008.  
  1009.      Show description
  1010.          If set  ON  show  a  short  descriptive  text  for  each
  1011.          displayed  newsgroup.   The  text used is taken from the
  1012.          $LIBDIR/newsgroups file.
  1013.  
  1014.      Show Author
  1015.          If  set  'None'  only  the  ``Subject:''  line  will  be
  1016.          displayed.   If  set  'Addr'  ``Subject:''  line  &  the
  1017.          address part of the ``From:'' line  are  displayed.   If
  1018.          set  'Name'  ``Subject:''  line  & the authors full name
  1019.          part of the ``From:'' line are displayed.  If set 'Both'
  1020.          ``Subject:''  line  &  all  of  the  ``From:''  line are
  1021.          displayed.
  1022.  
  1023.      Process type
  1024.          This specifies the default type of  post  processing  to
  1025.          perform  on  saved  articles.   The  following  types of
  1026.          processing are allowed:
  1027.              -none.
  1028.              -unpacking of multi-part shell archives.
  1029.              -unpacking of multi-part uuencoded files.
  1030.              -unpacking  of  multi-part  uuencoded  files,  which
  1031.               produce a *.zoo archive whose contents is listed.
  1032.              -unpacking  of  multi-part  uuencoded  files,  which
  1033.               produce   a   *.zoo   archive   whose  contents  is
  1034.               extracted.
  1035.              -unpacking  of  multi-part  uuencoded  files,  which
  1036.               produce a *.zip archive whose contents is listed.
  1037.              -unpacking  of  multi-part  uuencoded  files,  which
  1038.               produce   a   *.zip   archive   whose  contents  is
  1039.               extracted.
  1040.              -unpacking  of  multi-part  uuencoded  files,  which
  1041.               produce  a  *.lha  archive whose contents is listed
  1042.               (AmigaDOS version only).
  1043.              -unpacking  of  multi-part  uuencoded  files,  which
  1044.               produce a *.lha archive whose contents is extracted
  1045.               (AmigaDOS version only).
  1046.  
  1047.      Sort articles by
  1048.          This specifies  how  articles  should  be  sorted.   The
  1049.          following sort types are allowed:
  1050.  
  1051.  
  1052.  
  1053. April 6, 1993         Last change: Version 1.1 PL9                    16
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060. TIN(1)                           LOCAL                            TIN(1)
  1061.  
  1062.  
  1063.  
  1064.              -don't sort articles (default).
  1065.              -sort articles by ``Subject:''  field  (ascending  &
  1066.               descending).
  1067.              -sort  articles  by  ``From:''  field  (ascending  &
  1068.               descending).
  1069.              -sort  articles  by  ``Date:''  field  (ascending  &
  1070.               descending).
  1071.  
  1072.      Save directory
  1073.          The directory where articles/threads are  to  be  saved.
  1074.          Default is $HOME/News.
  1075.  
  1076.      Mail directory
  1077.          The directory where articles/threads are to be saved  in
  1078.          mailbox format.  This feature is mainly for use with the
  1079.          Elm  mail  program.   It  allows  the   user   to   save
  1080.          articles/threads/groups  simply  by  giving  '='  as the
  1081.          filename to save to.
  1082.  
  1083.      Printer
  1084.          The printer program with options that is to be  used  to
  1085.          print  articles.  Default is lpr for BSD machines and lp
  1086.          for SysV machines.
  1087.  
  1088. TINRC CONFIGURABLE VARIABLES
  1089.      The following variables are  user  configurable  by  editing
  1090.      $HOME/.tin/tinrc directly. It is hoped to eventually provide
  1091.      a menu to allow the setting of the most common variables.
  1092.  
  1093.      batch_save
  1094.          If set ON articles/threads will be saved in  batch  mode
  1095.          when  save  -S  or  mail  -M is specified on the command
  1096.          line. Default is OFF.
  1097.  
  1098.      beginner_level
  1099.          If set ON a mini menu of the most useful  commands  will
  1100.          be displayed at the bottom of the screen for each level.
  1101.          Default is ON.
  1102.  
  1103.      display_reading_prompt
  1104.          The prompt ``Reading...'' will be displayed when reading
  1105.          an article from a NNTP server to provide feedback to the
  1106.          user. Default is ON.
  1107.  
  1108.      force_screen_redraw
  1109.          Specifies whether a screen redraw should always be  done
  1110.          after certain external commands. Default is OFF.
  1111.  
  1112.      groupname_max_length
  1113.          Maximum  length  of  the  names  of  newsgroups  to   be
  1114.          displayed  so  that more of the newgroup description can
  1115.          be displayed. Default is 132.
  1116.  
  1117.  
  1118.  
  1119. April 6, 1993         Last change: Version 1.1 PL9                    17
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126. TIN(1)                           LOCAL                            TIN(1)
  1127.  
  1128.  
  1129.  
  1130.      default_sigfile
  1131.          The path that specifies the signature file to  use  when
  1132.          posting,  following  upto  or replying to an article. If
  1133.          the path is a  directory  then  the  signature  will  be
  1134.          randomly  generated from files that are in the specified
  1135.          directory.  Default is $HOME/.Sig.
  1136.  
  1137.      hot_art_mark
  1138.          The character used to show  that  an  article/thread  is
  1139.          auto-selected (hot). Default is '*'.
  1140.  
  1141.      quote_chars
  1142.          The character used in quoting included text  to  article
  1143.          followups  and mail replys. The '_' character represents
  1144.          a blank character and is replaced with '  '  when  read.
  1145.          Default is ':_'.
  1146.  
  1147.      reread_active_file_secs
  1148.          The news active file is reread at regular  intervals  to
  1149.          show  if  any  new  news  has  arrived.  Default  is 300
  1150.          seconds.
  1151.  
  1152.      return_art_mark
  1153.          The character used to show that an article will  return.
  1154.          Default is '-'.
  1155.  
  1156.      save_to_mmdf_mailbox
  1157.          Allows articles to be saved  to  a  MMDF  style  mailbox
  1158.          instead  of  mbox format.  Default is OFF unless reading
  1159.          news on SCO Unix which uses MMDF by default.
  1160.  
  1161.      show_last_line_prev_page
  1162.          The last line of the previous page will be displayed  as
  1163.          the first line of next page. Default is OFF.
  1164.  
  1165.      slow_speed_terminal
  1166.          Strips the blanks from the end of  each  line  therefore
  1167.          speeding  up the display when reading on a slow terminal
  1168.          or via modem. Default is OFF.
  1169.  
  1170.      tab_after_X_selection
  1171.          If enabled will  automatically  goto  the  first  unread
  1172.          article  after  having  selected  all  hot  articles and
  1173.          threads with the  'X'  command  at  group  index  level.
  1174.          Default is OFF.
  1175.  
  1176.      unread_art_mark
  1177.          The character used to show that an article has not  been
  1178.          read. Default is '+'.
  1179.  
  1180.      use_builtin_inews
  1181.          Allows the builtin NNTP inews  to  be  enabled/disabled.
  1182.  
  1183.  
  1184.  
  1185. April 6, 1993         Last change: Version 1.1 PL9                    18
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192. TIN(1)                           LOCAL                            TIN(1)
  1193.  
  1194.  
  1195.  
  1196.          Default is ON (enabled).
  1197.  
  1198.      use_keypad
  1199.          Allows  the  scroll   keys   on   the   keypad   to   be
  1200.          enabled/disabled on supported terminals. Default is OFF.
  1201.  
  1202. GROUP ATTRIBUTES
  1203.      Tin allows certain attributes to  be  set  on  a  per  group
  1204.      basis.  These  group  attributes  are  read  from  the  file
  1205.      $HOME/.tin/attributes.  A later version will provide a  menu
  1206.      interface  to  set  all  the attributes. At present you will
  1207.      have to edit the file with your editor  :-(.  The  following
  1208.      group attributes are available:
  1209.  
  1210.           newsgroup=alt.sources
  1211.           maildir=/usr/iain/Mail/sources
  1212.           savedir=/usr/iain/News/alt.sources
  1213.           sigfile=/usr/iain/.funny_sig
  1214.           organization=Wacky Bits Inc.
  1215.           followup_to=alt.sources.d
  1216.           printer=/usr/local/bin/a2ps -nn | /bin/lpr
  1217.           auto_save=ON
  1218.           batch_save=OFF
  1219.           delete_tmp_files=ON
  1220.           show_only_unread=OFF
  1221.           thread_arts=ON
  1222.           show_author=1
  1223.           sort_art_type=5
  1224.           post_proc_type=1
  1225.  
  1226.      Note that  the  ''newsgroup=<groupname>''  line  has  to  be
  1227.      specified  before  the  attributes  are  specified  for that
  1228.      group.
  1229.  
  1230.      All attributes are set to a reasonable default so  you  only
  1231.      have to specify the attribute that you want to change (i.e.,
  1232.      savedir).
  1233.  
  1234.      All toggle attributes are set by specifying ON/OFF.
  1235.  
  1236.      The show_author attribute is specified by a number from  the
  1237.      following  range:  0=none,  1=username,  2=network  address,
  1238.      3=both.
  1239.  
  1240.      The sort_art_type attribute is specified by  a  number  from
  1241.      the following range: 0=none, 1=subject descending, 2=subject
  1242.      ascending,  3=from  descending,  4=from  ascending,   5=date
  1243.      descending, 6=date ascending.
  1244.  
  1245.      The post_proc_type attribute is specified by a  number  from
  1246.      the   following   range:   0=none,   1=unshar,   2=uudecode,
  1247.      3=uudecode & list zoo  archive,  4=uudecode  &  extract  zoo
  1248.  
  1249.  
  1250.  
  1251. April 6, 1993         Last change: Version 1.1 PL9                    19
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258. TIN(1)                           LOCAL                            TIN(1)
  1259.  
  1260.  
  1261.  
  1262.      archive, 5=uudecode & list zip archive, 6=uudecode & extract
  1263.      zip archive. (note: if running on AmigaDOS the  zoo  options
  1264.      are replaced by there corresponding lha archiver options).
  1265.  
  1266. AUTOMATIC KILL AND SELECTION
  1267.      When there is a subject or an author which  you  are  either
  1268.      very  interested  in,  or find completely uninteresting, you
  1269.      can easily instruct tin to auto-select or auto-kill articles
  1270.      with  specific  subjects  or  from  specific authors.  These
  1271.      instructions are stored in a kill file.
  1272.  
  1273.      This menu is accessed by pressing '^K' at the group and page
  1274.      levels.   It  allows  the  user to kill or select an article
  1275.      that matches the current ``Subject:'' line,  ``From:''  line
  1276.      or a string entered by the user. The user entered string can
  1277.      be applied to the ``Subject:''  or  ``From:''  lines  of  an
  1278.      article.  The kill description can be limited to the current
  1279.      newsgroup or it can apply to all  newsgroups.  Once  entered
  1280.      the  user  can  abort  the  command  and  not  save the kill
  1281.      description,  edit  the  kill  file   or   save   the   kill
  1282.      description.
  1283.  
  1284.      On starting tin the users killfile $HOME/.tin/kill  is  read
  1285.      and  on entering a newsgroup any kill or select descriptions
  1286.      are applied.
  1287.  
  1288.      Articles that match a kill description are marked killed and
  1289.      are  not  displayed.  Articles  that  match  an  auto-select
  1290.      description are marked with a ''*'' when displayed.
  1291.  
  1292. POSTING ARTICLES
  1293.      Tin allows posting of articles, follow-up to already  posted
  1294.      articles  and  replying direct through mail to the author of
  1295.      an article.
  1296.  
  1297.      Use the 'w' command to  post  an  article  to  a  newsgroup.
  1298.      After entering the post subject the default editor (i.e. vi)
  1299.      or the editor specified by the $VISUAL environment  variable
  1300.      will  be  started  and  the  article  can  be  entered.   To
  1301.      crosspost articles simply add a comma and the  name  of  the
  1302.      newsgroup(s)  to  the end of the ``Newsgroups:'' line at the
  1303.      beginning of the article.   After  saving  and  exiting  the
  1304.      editor  you  are  asked  if  you  wish to a)bort posting the
  1305.      article, e)dit the article again or p)ost the article to the
  1306.      specified newsgroup(s).
  1307.  
  1308.      Use the 'W' command to display a history of the articles you
  1309.      have  posted.   The  date  the  article  was  posted,  which
  1310.      newsgroups the  article  was  posted  to  and  the  articles
  1311.      subject line are displayed.
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317. April 6, 1993         Last change: Version 1.1 PL9                    20
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324. TIN(1)                           LOCAL                            TIN(1)
  1325.  
  1326.  
  1327.  
  1328.      Use the 'f' / 'F' command to post a follow-up article to  an
  1329.      already  posted article.  The 'f' command will copy the text
  1330.      of the  original  article  into  the  editor.   The  editing
  1331.      procedure  is  the  same as when posting an article with the
  1332.      'w' command.
  1333.  
  1334.      Use the 'r' / 'R' command to reply direct  through  mail  to
  1335.      the  author  of  an already posted article.  The 'r' command
  1336.      will copy the text of the original article into the  editor.
  1337.      The editing procedure is the same as when posting an article
  1338.      with the 'w' command.  After saving and exiting  the  editor
  1339.      you  are  asked  if  you wish to a)bort sending the article,
  1340.      e)dit the article again or s)end the article to the author.
  1341.  
  1342. CUSTOMIZING THE ARTICLE QUOTE STRING
  1343.      When posting a followup to an article or replying direct  to
  1344.      the  author  of an article via email the text of the article
  1345.      can be quoted. The beginning of the quoted text can  contain
  1346.      information  about  the  quoted  article (i.e., Name and the
  1347.      Message  Id  of  the  article).  To  allow   for   different
  1348.      situations  certain information from the article can be used
  1349.      in the quoted string. The following variables  are  expanded
  1350.      if  found  in  the  tinrc  variables 'mail_quote_format=' or
  1351.      'news_quote_format=':
  1352.           %A  Address (Email)
  1353.           %D  Date
  1354.           %F  Full address (%N (%A))
  1355.           %G  Groupname
  1356.           %M  Message Id
  1357.           %N  Name of user
  1358.      i.e.,
  1359.           mail_quote_format=On %D in %G you wrote:
  1360.           news_quote_format=In %M, %F wrote:
  1361.      would expand when used to:
  1362.           On 21 Jul 1992 09:45:51 -0400 in alt.sources you wrote:
  1363.           In <abcINN123@anl433.uucp>, Iain Lea (iain@anl433.uucp) wrote:
  1364.  
  1365. MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES
  1366.      The command interface  to  mail  ('m'),  pipe  ('|'),  print
  1367.      ('o'),  crosspost  ('x') and save ('s') articles is the same
  1368.      for ease of use.
  1369.  
  1370.      The initial command will ask you to select  which  a)rticle,
  1371.      t)hread,   h)ot  (auto  selected)  r)egex  pattern,  t)agged
  1372.      articles you wish to mail, pipe etc.
  1373.  
  1374.      Tagged articles must have already been tagged with  the  'T'
  1375.      command.   All  tagged  articles  can be untagged by the 'U'
  1376.      untag command.
  1377.  
  1378.      If regex pattern matching is selected you are asked to enter
  1379.      a  regular  expression  (i.e.  to match all articles subject
  1380.  
  1381.  
  1382.  
  1383. April 6, 1993         Last change: Version 1.1 PL9                    21
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390. TIN(1)                           LOCAL                            TIN(1)
  1391.  
  1392.  
  1393.  
  1394.      lines containing 'net News' you must  enter  '*net  News*').
  1395.      Any  articles  that  match  the  entered  expression will be
  1396.      mailed, piped etc.
  1397.  
  1398.      To save articles to a mailbox with the name of  the  current
  1399.      newsgroup  (i.e. Alt.sources) enter '=' or '=<mailbox name>'
  1400.      when asked for the save filename.
  1401.  
  1402.      To save articles in <newsgroup name>/<filename> format enter
  1403.      '+<filename>'.
  1404.  
  1405.      When saving articles you can specify whether the saved files
  1406.      should   be  post  processed  (i.e.  unshar  shell  archive,
  1407.      uudecode multiple parts etc).  A default process type can be
  1408.      set by the 'Process type:' in the 'M' options menu.
  1409.  
  1410. AUTOMATIC MAILING AND SAVING NEW NEWS
  1411.      Tin  allows  new/unread  news  articles  to  be  mailed  (-M
  1412.      option)/saved  (-S  option) in batch mode for later reading.
  1413.      Useful when going on holiday and you don't  want  to  return
  1414.      and  find  that  expire  has  removed a whole load of unread
  1415.      articles.  Best to run from  crontab  everyday  while  away,
  1416.      after  which  you  will be mailed a report of which articles
  1417.      were mailed/saved from which newsgroups and the total number
  1418.      of  articles  mailed/saved.  Articles are saved in a private
  1419.      news structure under your <savedir>  directory  (default  is
  1420.      $HOME/News).   Be careful of using this option if you read a
  1421.      lot of groups because you could  overflow  your  filesystem.
  1422.      If  you  only  want to save a few groups it would be best to
  1423.      backup your full $HOME/.newsrc and create  a  new  one  that
  1424.      only  contains  the newsgroups you want to mail/save.  Saved
  1425.      news can be read later by tin -R.
  1426.  
  1427.      tin -M iain -f newsrc.mail
  1428.                          (mail any unread articles  in  newgroups
  1429.                          specified in file newsrc.mail)
  1430.  
  1431.      tin -S -f newsrc.save
  1432.                          (save any unread articles  in  newgroups
  1433.                          specified in file newsrc.save)
  1434.  
  1435.      tin -R              (read any articles saved by tin -S)
  1436.  
  1437. SIGNATURES
  1438.      Tin will recognize a signature in either $HOME/.signature or
  1439.      $HOME/.Sig.   If $HOME/.signature exists, then the signature
  1440.      will be  pulled  into  the  editor  for  mail  commands.   A
  1441.      signature  in  $HOME/.signature  will not be pulled into the
  1442.      editor for posting commands  since  inews  will  append  the
  1443.      signature itself.
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449. April 6, 1993         Last change: Version 1.1 PL9                    22
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456. TIN(1)                           LOCAL                            TIN(1)
  1457.  
  1458.  
  1459.  
  1460.      A signature in $HOME/.Sig will be pulled into the editor for
  1461.      both posting and mailing commands.
  1462.  
  1463.      The following is an example of a $HOME/.Sig file:
  1464.           NAMES  Iain Lea    Iain.Lea%anl433.uucp@Germany.EU.net
  1465.           SNAIL  Bruecken Strasse 12, 8500 Nuernberg 90, Germany
  1466.           PHONE  +49-911-331963 (home)  +49-911-3089-407 (work)
  1467.      Tin also has the capability to generate random signatures on
  1468.      a  per  newsgroup basis if so desired. The way to accomplish
  1469.      this is to  specify  the  default  signature  or  the  group
  1470.      attribute  sigfile  as  a  directory.   If  for  example the
  1471.      sigfile path is /usr/iain/.sigs and  .sigs  is  a  directory
  1472.      then  tin  will select a random signature from any file that
  1473.      is in the directory .sigs (note: one signature per  numbered
  1474.      file).  A  random signature can also consist of a fixed part
  1475.      signature that can contain your name, address etc.  followed
  1476.      by  the random sig. The fixed part of the random sig is read
  1477.      from the file $HOME/.sigfixed.
  1478.  
  1479. ENVIROMENT VARIABLES
  1480.      TINRC
  1481.           Define this variable if you  want  to  specify  command
  1482.           line  options  that  tin should be started with to save
  1483.           typing them each time it is started.  The  contents  of
  1484.           the  environment variable are added to the front of the
  1485.           command line options  before  it  is  parsed  therefore
  1486.           allowing  an  option  specified  on the command line to
  1487.           override the same option specified in the environment.
  1488.  
  1489.      TINDIR
  1490.           Define this variable  if  you  do  not  want  the  .tin
  1491.           directory  in  $HOME/.tin.  (i.e. if you want all tin's
  1492.           private files in /tmp/.tin  you  would  set  TINDIR  to
  1493.           /tmp.
  1494.  
  1495.      TIN_INDEX
  1496.           Define this variable if you  do  not  want  the  .index
  1497.           directory  in  $HOME/.tin/.index. (i.e. if you want all
  1498.           tin's  index  files  in  /tmp/.index  you   would   set
  1499.           TIN_INDEX to /tmp.
  1500.  
  1501.      NNTPSERVER
  1502.           The default NNTP server to  remotely  read  news  from.
  1503.           This  variable  only  needs to be set if the -r command
  1504.           line option is specified and the  file  /etc/nntpserver
  1505.           does not exist.
  1506.  
  1507.      DISTRIBUTION
  1508.           Set the article header field ``Distribution:''  to  the
  1509.           contents of the variable instead of the system default.
  1510.  
  1511.      ORGANIZATION
  1512.  
  1513.  
  1514.  
  1515. April 6, 1993         Last change: Version 1.1 PL9                    23
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522. TIN(1)                           LOCAL                            TIN(1)
  1523.  
  1524.  
  1525.  
  1526.           Set the article header field ``Organization:''  to  the
  1527.           contents of the variable instead of the system default.
  1528.           This   variable   has   precedence   over   the    file
  1529.           $HOME/.tin/organization   that   may  also  contain  an
  1530.           organization string.  If  reading  news  on  an  Apollo
  1531.           DomainOS  machine  the environment variable NEWSORG has
  1532.           to be used instead of ORGANIZATION.
  1533.  
  1534.      REPLYTO
  1535.           Set the  article  header  field  ``Reply-To:''  to  the
  1536.           return  address  specified  by  the  variable.  This is
  1537.           useful if the machine is not  registered  in  the  UUCP
  1538.           mail  maps  or  if  you  wish  to  receive replies at a
  1539.           different machine.  This variable has  precedence  over
  1540.           the  file  $HOME/.tin/replyto  that  may also contain a
  1541.           return address.
  1542.  
  1543.      ADD_ADDRESS
  1544.           This can contain an address to  append  to  the  return
  1545.           address when replying directly through mail to somebody
  1546.           whose mail address is not directly  recognized  by  the
  1547.           local  host.   For  example  say  the return address is
  1548.           user@bigvax, but bigvax is not recognized by your host,
  1549.           so  therefore  the  mail  will not reach user.  But the
  1550.           host littevax is  known  to  recognize  your  host  and
  1551.           bigvax,   so   if  ADD_ADDRESS  is  set  (i.e.  'setenv
  1552.           ADD_ADDRESS @littevax'  for  csh  or  'set  ADD_ADDRESS
  1553.           @littevax' and 'export ADD_ADDRESS' for sh) the address
  1554.           user@bigvax@littlevax will be used and  the  mail  will
  1555.           reach  user@bigvax.   This variable has precedence over
  1556.           the file $HOME/.tin/add_address that may  also  contain
  1557.           an address.
  1558.  
  1559.      BUG_ADDRESS
  1560.           If the 'B' command  bug  report  mail  address  is  not
  1561.           correct this variable should be set to the correct mail
  1562.           address.  This variable has precedence  over  the  file
  1563.           $HOME/.tin/bug_address  that  may  also  contain a mail
  1564.           address.
  1565.  
  1566.      MAILER
  1567.           This variable has precedence over  the  default  mailer
  1568.           that is used in all mailing operations within tin (i.e.
  1569.           replying 'rR', and bug reports 'B').
  1570.  
  1571.      VISUAL
  1572.           This variable has precedence over  the  default  editor
  1573.           (i.e. vi) that is used in all editing operations within
  1574.           tin (i.e. posting 'w', replying 'rR',  follow-ups  'fF'
  1575.           and bug reports 'B').
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581. April 6, 1993         Last change: Version 1.1 PL9                    24
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588. TIN(1)                           LOCAL                            TIN(1)
  1589.  
  1590.  
  1591.  
  1592. TIPS AND TRICKS
  1593.      Tin can be pretty much be navigated by using the four cursor
  1594.      keys.  The  left  arrow key goes up a level, the right arrow
  1595.      key goes down a level, the up arrow key goes up a line (page
  1596.      at  article viewer level) and the down arrow key goes down a
  1597.      line (page at article viewer level).
  1598.  
  1599.      The  following   newsgroups   provide   useful   information
  1600.      concerning news software:
  1601.          -news.software.readers (info.  about  news  user  agents
  1602.           tin,rn,nn,vn etc.)
  1603.          -news.software.nntp (info. about NNTP)
  1604.          -news.software.b  (info.  about  news  transport  agents
  1605.           Bnews,Cnews and INN)
  1606.          -news.answers (Frequently Asked  Questions  (FAQ)  about
  1607.           many different themes)
  1608.  
  1609.      Many prompts (i.e. 'Mark  everything  as  read?  (y/n):  y')
  1610.      within  tin  offer  a  default  choice  that  the  cursor is
  1611.      positioned on.  By pressing <CR> the default value is taken.
  1612.  
  1613.      Many prompts (i.e. 'Post subject []>')  within  tin  can  be
  1614.      aborted by pressing ESC.
  1615.  
  1616.      When tin is run in an xterm window  it  will  resize  itself
  1617.      each time the xterm is resized.
  1618.  
  1619.      Tin will reread the active file at set intervals to show any
  1620.      new news.
  1621.  
  1622. FILES
  1623.      $HOME/.newsrc       subscribed to newgroups.
  1624.  
  1625.      $HOME/.newsauth     ``nntpserver password'' pairs  for  NNTP
  1626.                          servers that require authorization.
  1627.  
  1628.      $HOME/.tin/tinrc    options.
  1629.  
  1630.      $HOME/.tin/attributes
  1631.                          contains    user     specified     group
  1632.                          attributes.
  1633.  
  1634.      $HOME/.tin/.index   newsgroups index files directory.
  1635.  
  1636.      $HOME/.tin/.mailidx mailgroups index files directory.
  1637.  
  1638.      $HOME/.tin/.saveidx saved newsgroups index files directory.
  1639.  
  1640.      $HOME/.tin/active.mail
  1641.                          active file of users mailgroups.
  1642.  
  1643.      $HOME/.tin/active.save
  1644.  
  1645.  
  1646.  
  1647. April 6, 1993         Last change: Version 1.1 PL9                    25
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654. TIN(1)                           LOCAL                            TIN(1)
  1655.  
  1656.  
  1657.  
  1658.                          active file of users saved newsgroups.
  1659.  
  1660.      $HOME/.tin/add_address
  1661.                          address to add to when replying  through
  1662.                          mail.
  1663.  
  1664.      $HOME/.tin/bug_address
  1665.                          address to send bug reports to.
  1666.  
  1667.      $HOME/.tin/kill     article kill and auto-selection file.
  1668.  
  1669.      $HOME/.tin/organization
  1670.                          string to replace default organization.
  1671.  
  1672.      $HOME/.tin/posted   history of articles posted by user.
  1673.  
  1674.      $HOME/.tin/replyto  host address  to  use  in  ``Reply-To:''
  1675.                          mail header.
  1676.  
  1677.      $HOME/.signature    signature.
  1678.  
  1679.      $HOME/.Sig          signature.
  1680.  
  1681.      $HOME/.sigfixed     fixed  part  of  a  randomly   generated
  1682.                          signature.
  1683.  
  1684.      /usr/lib/news/motd  News message of the day file.
  1685.  
  1686.      /usr/lib/news/newsgroups
  1687.                          Short description of all newsgroups.
  1688.  
  1689.      /usr/lib/news/subscriptions
  1690.                          List of newsgroups  to  subscribe  first
  1691.                          time user to.
  1692.  
  1693. BUGS
  1694.      There are bugs somewhere among the creeping featurism.   Any
  1695.      bugs  found  should  be  reported  by  the  'B' (bug report)
  1696.      command.
  1697.  
  1698.      Will    not    uudecode    some    of    the    images    in
  1699.      alt.binaries.pictures  because more than one image is in the
  1700.      multi-part file to uudecode.  Only the first image  will  be
  1701.      uudecoded.
  1702.  
  1703.      Does not  yet  handle  ``Xref:''  headers  for  cross-posted
  1704.      articles.
  1705.  
  1706.      Coredumps when  setting  certain  toggle  options  from  the
  1707.      options menu at article viewer level.
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713. April 6, 1993         Last change: Version 1.1 PL9                    26
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720. TIN(1)                           LOCAL                            TIN(1)
  1721.  
  1722.  
  1723.  
  1724.      Coredumps when killing last article in a thread  at  article
  1725.      viewer level.
  1726.  
  1727. HISTORY
  1728.      Based on the tass newsreader  that  was  developed  by  Rich
  1729.      Skrenta  and  posted to alt.sources in March 1991.  Tass was
  1730.      itself heavily influenced by NOTES which  was  developed  at
  1731.      the  University of Illinois by Ray Essick and Rob Kolstad in
  1732.      1982.
  1733.  
  1734.      v1.0 PL0 (full) was posted in 8 parts to alt.sources  on  23
  1735.      Aug 1991.
  1736.      v1.0 PL1 (full) was posted in 8 parts to alt.sources  on  03
  1737.      Sep 1991.
  1738.      v1.0 PL2 (full) was posted in 9 parts to alt.sources  on  24
  1739.      Sep 1991.
  1740.      v1.0 PL3 (patch) was posted in 4 parts to alt.sources on  30
  1741.      Sep 1991.
  1742.      v1.0 PL4 (patch) was posted in 2 parts to alt.sources on  02
  1743.      Oct 1991.
  1744.      v1.0 PL5 (patch) was posted in 4 parts to alt.sources on  17
  1745.      Oct 1991.
  1746.      v1.0 PL6 (patch) was posted in 5 parts to alt.sources on  27
  1747.      Nov 1991.
  1748.      v1.0 PL7 (patch) was posted in 2 parts to alt.sources on  27
  1749.      Nov 1991.
  1750.      v1.1 PL0 (full) was posted in 11 parts to alt.sources on  13
  1751.      Feb 1992.
  1752.      v1.1 PL1 (full) was posted in 12 parts to alt.sources on  24
  1753.      Mar 1992.
  1754.      v1.1 PL2 (patch) was posted in 4 parts to alt.sources on  30
  1755.      Mar 1992.
  1756.      v1.1 PL3 (full) was posted in 15 parts to alt.sources on  13
  1757.      May 1992.
  1758.      v1.1 PL4 (full) was posted in 15 parts to alt.sources on  22
  1759.      Jun 1992.
  1760.      v1.1 PL5 (patch) was posted in 7 parts to alt.sources on  11
  1761.      Aug 1992.
  1762.      v1.1 PL6 (full) was posted in 15 parts to alt.sources on  14
  1763.      Sep 1992.
  1764.      v1.1 PL7 (patch) was posted in 10 parts to alt.sources on 15
  1765.      Nov 1992.
  1766.      v1.1 PL8 (patch) was posted in 6 parts to alt.sources on  06
  1767.      Dec 1992.
  1768.      v1.1 PL9 (patch) was posted in 3 parts to alt.sources on  20
  1769.      Mar 1993.
  1770.  
  1771. CREDITS
  1772.      Rich Skrenta   author of tass  v3.2  which  this  newsreader
  1773.                     used as its base.
  1774.  
  1775.      Bill Davidsen  author  of  envarg.c   environment   variable
  1776.  
  1777.  
  1778.  
  1779. April 6, 1993         Last change: Version 1.1 PL9                    27
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786. TIN(1)                           LOCAL                            TIN(1)
  1787.  
  1788.  
  1789.  
  1790.                     reading routine.
  1791.  
  1792.      Mike Gleason   author   of   sigfile.c   random    signature
  1793.                     generation  routines.   Arnold Robbins author
  1794.                     of strftime.c date formatting routine.
  1795.  
  1796.      Jim Robinson   co-author of kill.c article  kill  and  auto-
  1797.                     selection routines.
  1798.  
  1799.      Rich Salz      author  of  wildmat.c  pattern  matching  and
  1800.                     parsedate.y date parsing routines.
  1801.  
  1802.      Dave Taylor    author of curses.c from the elm mailreader.
  1803.  
  1804.      Chris Thewalt  author  of  getline.c  emacs  style   editing
  1805.                     routine.
  1806.  
  1807.      Mark Tomlinson for porting tin  to  the  Commodore  AmigaDOS
  1808.                     operating system.
  1809.  
  1810.      Dieter Becker  for generously posting certain  releases  for
  1811.                     me  when  my  net connection was removed by a
  1812.                     group of very short sighted people.
  1813.  
  1814.      I wish to thank the following people for supplying patches:
  1815.  
  1816.      Earle Ake, Anton Aylward, Paul Bauwens, Dieter  Becker,  Dan
  1817.      Berry,  David  Binderman, Fokke de Boer, Marc Boucher, Leila
  1818.      Burrell-Davis,  Peter   Castro,   Robert   Claeson,   Steven
  1819.      Cogswell,  Don  Costello,  Ned  Danieley, Chris Davies, John
  1820.      Davis, Craig Durland, Kirk Edson,  Stefan  Elf,  Rob  Engle,
  1821.      Brent  Ermlick, Olle Eriksson, Michael Faurot, Werner Fleck,
  1822.      Callum Gibson, Carl Hage, Paul  Halsema,  Ed  Hanway,  Scott
  1823.      Hauck, Per Headland, Daniel Hermans, Jose Herrero, Tom Hite,
  1824.      Torsten Homeyer, Tommy Hsieh, Steve  Hunt,  Robbin  Johnson,
  1825.      Nelson  Kading,  Fritz  Kleeman, Dwarven Knight, Karl-Koenig
  1826.      Koenigsson, Martin Kraemer, Kris Kugel,  Alex  Lange,  Hakan
  1827.      Lennestal,  Geoff  Lane, Marty Leisner, Clifford Luke, David
  1828.      MacKenzie, Hugh  Mahon,  Sergio  Morales,  Udo  Munk,  James
  1829.      Nugen, Jeb Palmer, Neil Parker, Tom Parry, Walter Pelissero,
  1830.      Eric Peterson, Tim Pierce, Bill Poitras, Wolfgang  Prediger,
  1831.      Ted Richards, Jim Robinson, Stephen Roseman, Nickolay Saukh,
  1832.      Rich Salz, Gary Sanders, John  Sauter,  John  Schmitz,  Bart
  1833.      Sears,  Karl-Olav  Serrander,  Doug  Sewell, Steve Spearman,
  1834.      Cliff Stanford, Steve Starck,  Ed  Sznyter,  Derek  Terveer,
  1835.      Andry  Timonin,  Mark  Tomlin,  Michael Traub, Adri Verhoef,
  1836.      Paul Vickers, Cary Whitney, Greg Woods, Lloyd Wright
  1837.  
  1838.      I   wish   to   thank   the   following   people   for   bug
  1839.      reports/comments:
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845. April 6, 1993         Last change: Version 1.1 PL9                    28
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852. TIN(1)                           LOCAL                            TIN(1)
  1853.  
  1854.  
  1855.  
  1856.      Jack  Applin,  Klaus  Arzig,  Scott  Babb,  Reiner  Balling,
  1857.      Preston  Bannister,  Bill  de Beabien, Volker Beyer, Etienne
  1858.      Bido, Roger Binns, Georg Biehler, Jean-Marc Bonnaudet,  Eric
  1859.      Bowles,  Sean Brady, Ian Brown, Andreas Brosig, Craig Bruce,
  1860.      Tom Czarnik, Dave Datta, Mat  Davis,  Klaus  Dimmler,  David
  1861.      Donovan,  Peter  Dressler, Gerhard Ermer, Hugh Fader, Miguel
  1862.      Farah,  Joachim  Feld,  Paul  Fox,  Jay  Geertsen,  Bernhard
  1863.      Gmelch,  Jason  Haar, Viet Hoang, Andy Jackson, Joe Johnson,
  1864.      Cyrill  Jung,  Kuo-Chein  Kai,  Tonis  Kelder,  Hans-Juergen
  1865.      Knopp,  Sridhar  Komandur,  Tom  Kovar,  Bernhard  Kroenung,
  1866.      Murray Laing, Per Lindqvist, Eric Litman, Bob Lukas, Michael
  1867.      Marshall,  Kazushi Marukawa, Phillip Molloy, Toni Metz, Greg
  1868.      Miller, Deeptendu Majumder, Klaus Neuberger,  Otto  Niesser,
  1869.      Reiner Oelhaf, Alex Pakter, John Palkovic, Dave Pascoe, Wolf
  1870.      Paul, Andrew Phillips, Stefan Rathmann, Jon Robinson,  David
  1871.      Ross,  Jonas  Rwgmyr, Daemon Schaefer, Dean Schrimpf, Klamer
  1872.      Schutte, Fredy Schwatz, Dave  Schweisguth,  Bernd  Schwerin,
  1873.      Don  Sheythe, Chris Smith, Daniel Smith, Hironobu Takahashi,
  1874.      Ken Taylor, Tony Travis,  Paul  Verket,  Sven  Werner,  Dick
  1875.      Wexelblat,  Paul  Wood, Gregory Woodbury, Norm Yamane, Blair
  1876.      Zajac, Orest Zboroski, Thomas Ziegler
  1877.  
  1878. AUTHOR
  1879.      Iain Lea  (Iain.Lea%anl433.uucp@Germany.EU.net)
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911. April 6, 1993         Last change: Version 1.1 PL9                    29
  1912.  
  1913.  
  1914.  
  1915.